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AS/400 INFORMATION 


The following information expiains how to instaii, initialize, and set up the AST-5250FT/11 
instailation software on your AS/400 system, instructions are aiso provided for running 
AST-5250FT/11 on your PC, and for responding to errors. 

General Information 

Tabie 1 shows the AS/400 parameter values required for AST-5250FT/11 operation. 


Table 1. System Parameters. 


Type 

AS/400 Parameter Values 

Memory Requirements 

Approx. 200 KB for each user 

Disk Requirements 

Installation 1.3 megabyte (MB) 

Users Supported 

Limited by system capacity 

Views 

Limited by system 

View Capabilities 

Related Files 

One 

Record Size 

Physical record = up to 32,766 bytes 
(Only first 512 bytes may be accessed) 

Field Sizes 

Alphanumeric = 1-256 (1-29 if key) 
Zoned decimal = 1-16 

Packed = 1-8 (15 digits) 

Binary = 1, 2, 3, or 4 bytes 

Number of Records 

Unlimited 

Constraints 

See note 


To run AST-5250FT/11, you must be in DOS. Once AST-5250FT/11 is activated from a PC, any 
system message sent to the emulated terminal’s screen aborts the session and posts the foilowing 
message: 


Communication Lost 

if this occurs, hot-key from DOS to emulation mode to determine the problem. 
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NOTE 


The emulated session assigned for file transfer should not be in Workstation Break 
Mode, and authorized users of the SNDBRKMSG command must not interrupt an 
emulated workstation using AST-5250FT/11. 


AST-5250FT/11 AS/400 Files 

When you first install the AST-5250FT/11 installation software from a floppy disk, the system 
creates the DUNK library and loads it with the menus, procedures, and utilities needed for 
AST-5250FT/11 operation. The normal size of the AS/400 library is 1.3 megabytes (MB). 

The prefix DL (DL System/38) denotes the AST-5250FT/11 AS/400 data files in the library DUNK. 
These files are listed in Table 2. 

Successive installations change only the basic execution members and do not affect other 
contents of the library. 


Table 2. AST-5250FT/11 AS/400 Data Flies . 


File Name 

Explanation 

DLCF 

Control File. This file holds the user 
security profiles and data base view 
objects defined by System/38 operations. 

DLVW 

View Source File. This file holds the 

defined view source members. 

DLVWW 

View Work File. This file is used as a 

work file for various processes. 


Views 

Users obtain access to the AS/400 data base using a view. 

A view defines the fields of interest within a physical file or a logical file. The difference between a 
physical file and a logical file is that a physical file contains actual data, and a logical file references 
physical files (tells you which physical files to go to to obtain data). 

You can create, edit, or delete views. Once you create or edit a view, the system generates a 
report showing the record format. See the section titled, AS/400 System Setup, for more 
information. 
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Installation 


The AST-5250FT/11 installation software is on a floppy disk. Use the floppy disk to load the 
software onto your AS/400 system. The following instructions guide you through the installation 
procedure. 


AS/400 System Installation 

For System/38 users converting to the AS/400, save and restore library DLINK. Ail existing 
definitions (Views and User Security) will be preserved. 

STEP 1 

Sign on as a master security officer. 

STEP 2 

Enter the following command: 

RSTLIB SAVLIB(DLINK) DEV(dv) MBROPT(*ALL) 

dv is the disk drive device Id (often "H") 

When you press < Enter >, the installation begins. The procedure takes about 15 minutes. 

NOTE 

The AS/400 does not permit libraries created at one release level to be installed on 
a lower release level. Installation on a higher release level is allowed. If the disk 
will not install because of this release Incompatibility, bring your system up to the 
latest level. 
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Initialization 


STEP 1 

If this is the first installation, enter the following command to create the AST-5250FT/11 files 
(Table 2) and the default user profile DL38. 

CALL QCL 
CALL DLINIT.DLINK 

The File Transfer Installation screen appears. 
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File Transfer Installation Procedure in Progress 


DecIslonLink - Copyright (c) 1985, Laguna Laboratories, Inc. 
Version x.xx 




j 


Figure 1. File Transfer installation Screen. 


STEP 2 

Besides the Security Officer, other users can access AST-5250FT/11. Enter the following 
command for each user: 

CALL QCL 

GRTOBJAUT OBJ(*ALLDLINK) OBJTYPE(*ALL) USER(userprofiie) AUT(*ALL) 

(Userprofile is the user profile name, a 10-character alphanumeric variable.) 

STEP 3 

You must add the file transfer library DUNK to each user’s library list before any files can be 
transferred. Enter the following command: 

ADDLiBLE DUNK 

This completes the initialization procedure. To set up your system, proceed to the next section. 
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AS/400 System Setup 

To activate the AST-5250FT/11 menu system, enter the following command: 

CALL QCL 
CALL DLINK.DLINK 

This command adds DUNK to the user’s library list and brings up the AST-5250FT/11 Master 
menu. 
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AST FILE TRANSFER MASTER MENU 

1. User Security 

2. Data Base Views 

3. Message Function 

4. Print Function 
24. Sign Off 




Figure 2. Master Menu (AS/400 System). 



Options 1-3 on the menu in Figure 2 are described in theAST-5250FTI11 Operator's Manual. The 
only change for AS/400 is that option 2, Data Base Views, branches to a menu that contains a new 
option. The new option allows you to create views from Data Definition Specifications (DDS) by 
specifying the following; 

• The View Name and Library 

• View Header Specification 

• Record Definition Specification (DDS File Name) 


Running 5250FT/11 on Your PC 

There are two types of PC users, those with extended command entry capabilities, and those with 
limited command entry capabilities. 


Extended Command Entry Capabilities 

Users with extended command entry capabilities must have their own signon. Follow the 
procedure outlined below. 

STEP 1 

Sign on with your password. 

STEP 2 

Enter the following command: 

CALL QCL 

A command entry screen appears. 

STEP 3 

Use the hot key sequence to go to DOS. 

STEP 4 

Enter the following command to run the file transfer program. 

ASTFT11 
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Limited Command Entry Capabilities 


Users with limited command entry capabilities use the standard signon, DL38, which brings up the 
screen in Figure 3. To run the file transfer program from this screen, follow the procedure outlined 
below. 


- ^ 

AST-5250/FT/11 

Select the following: 

90. Signoff 

This menu is provided for 
PC File Transfer users and 
is not intended for use by 
System/38 operations. 

PC users should HOT-KEY 
to PC mode to activate 
AST-5250FT/11. 

System/38 users should enter 
option 90 to SIGNOFF. 

Option 

_I_/ 

Figure 3. Activation Menu. 


STEP 1 

When you see the screen in Figure 3, use the hot-key sequence to go to the DOS. 

STEP 2 

Enter the following command: 

ASTFT11 ACT=1-90 

A window is displayed. You must now contact your systems administrator for the proper access 
procedure. 
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Problem Determination 


If you get an error message, for example, Member Not Found, follow the procedure outlined below 
to determine the nature of the problem. 

STEP 1 

Hot-key to emulation. 

STEP 2 

If F10 appears at the bottom of your screen, press F10 to display a more detailed message. 

If F10 does not appear at the bottom of your screen, follow steps 3 through 5. 

STEP 3 

Press System Request. 

STEP 4 

Select option 3 (Display Job). 

STEP 5 

Select option 12, Display Job Log, for a detailed message regarding the error. 
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PROTOTYPE VIEWS 


The views for accessing source members from a source physical file and downloading print spool 
data are shown below. These are prototypes (only the names of the file and library change). 


Source Member Access View 


The following information summarizes the Source Member Access view. 


View Title 

VIEW TITLE SOURCE MEMBER VIEW 

ACCESS (R,E,L) L 

SECURITY ACCESS (0-16) 00 

GROUP ACCESS 


View Record Definition 


FILE NAME CRPGSRC 

LIBRARY NAME LIBRARY 

MEMBER NAME CRPGSRC 

ACCESS (I = INDEXED, 

R = RELATIVE RECORD) R 


Source file 
library 

same as file name 


View Fieid Specifications 


FIELD NAME KEY 

FIELD DESCRIPTION 
FIELD TYPE (,K,D) K 

STARTING POSITION 1 

ENDING POSITION 1 

DATA FORMAT (A,N,P,B) A 
DECIMAL POSITIONS 
SECURITY LEVEL (0-9) 

LOGICAL FIELD NUMBER 

FIELD NOTES / CODES 

FIELD NAME SOURCE 

FIELD DESCRIPTION 

FIELD TYPE (,K,D) 

STARTING POSITION 1 

ENDING POSITION 92 

DATA FORMAT (A,N,P,B) A 
DECIMAL POSITIONS 
SECURITY LEVEL (0-9) 

LOGICAL FIELD NUMBER 1 

FIELD NOTES/CODES 


dummy key 


Field length Is arbitrary - 
actual length of member Is used. 


Only one logical field. 
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Get Print Data View 


The following information summarizes the Print view. 

View Title 

VIEW TITLE GET PRINT DATA VIEW 

ACCESS (R,E,L) R 

SECURITY ACCESS (0-16) 00 

GROUP ACCESS 

View Record Definition 

FILE NAME LISTING File from CPYSPLF 

LIBRARY NAME LIBRARY Library 

MEMBER NAME LISTING same as file name 

ACCESS (I = INDEXED, 

R = RELATIVE RECORD) R 

View Field Specifications 

FIELD NAME KEY 

FIELD DESCRIPTION PRINT CONTROL from 

PRTCTL 

FIELD TYPE (,K,D) K 

STARTING POSITION 1 

ENDING POSITION 4 

DATA FORMAT (A,N,P,B) A 

DECIMAL POSITIONS 
SECURITY LEVEL (0-9) 

LOGICAL FIELD NUMBER 1 

FIELD NOTES / CODES 


FIELD NAME PRUNE 

FIELD DESCRIPTION PRINT LINE 

FIELD TYPE (,K,D) 

STARTING POSITION 5 

ENDING POSITION 136 132 char print line 

DATA FORMAT (A,N,P,B) A 

DECIMAL POSITIONS 
SECURITY LEVEL (0-9) 

LOGICAL FIELD NUMBER 2 

FIELD NOTES/CODES 


10 



